Fritz: All Fritz/All Fritz.zip/All Fritz/FILES/UTILREEN/NEWKEY.LZH/NEWKEY54.EXE/README

Text File | 1990-12-08 | 17KB | 434 lines

This contains:

- The latest information on changes to Newkey since version 5.0

- Information on how to upgrade version 4.0 macro files to version 5.0
macro files

- Hints on using Newkey functions

- The latest information on software and hardware compatibility

RECENT CHANGES

Version 5.4

- A new macro function, {prtscrn}, that will invoke the "print screen"
function has been added.  Use the macro editor to insert this function.
Pressing the "print screen" key will NOT cause the {prtscrn} function to
be inserted in the macro.

- Several new macro functions have been added to make it possible to
test the screen:

   {ifescr row,col}TEXT{endife}

            - If the contents of the screen starting at row,
              column equal "TEXT" then execute the macro function
              immediately following.  "TEXT" can be any characters that can
              be displayed on the screen.  For example:

               {ifescr 0,75}READY{endife}<go123><nextmac>

              Assume the above is in a macro designed to be used by
              Lotus 1-2-3.  When executed, Newkey would check row 0
              column 75 of the screen for "READY" and if found, it
              would execute the <go123> macro, otherwise it would skip
              the <go123> macro.

   {ifnescr row,col}TEXT{endifne}

            - If the contents of the screen starting at row,
              column do not equal "TEXT" then execute the macro function
              immediately following.  For example:

               {ifnescr 0,75}READY{endifne}<go123><nextmac>

              Assume the above is in a macro designed to be used by
              Lotus 1-2-3.  When executed, Newkey would check row 0
              column 75 of the screen for "READY" and if not found, it
              would execute the <go123> macro, otherwise it would skip
              the <go123> macro.

   {ifefscr row,col}TEXT{endifef}

            - If "TEXT" is found anyplace on the screen execute the macro
              function immediately following.  For example:

               {ifefscr}READY{endifef}<go123><nextmac>

              Assume the above is in a macro designed to be used by Lotus
              1-2-3.  When executed, Newkey would the full screen for
              "READY" and if found, it would execute the <go123> macro,
              otherwise it would skip the <go123> macro.

   {ifnefscr row,col}TEXT{endifne}

            - If "TEXT" is not found anyplace on the screen execute the
              macro function immediately following.  For example:

               {ifnefscr}READY{endifnef}<go123><nextmac>

              Assume the above is in a macro designed to be used by
              Lotus 1-2-3.  When executed, Newkey would check the full
              screen for "READY" and if not found, it would execute the
              <go123> macro, otherwise it would skip the <go123> macro.

The if macro functions are probably the most difficult of Newkey's macro
functions to use.  See EXAMPLE.KEY for some sample if macros that will work
at the DOS prompt and demonstrate some of the powerful things that can be
done..

   {cancel} - cancel all currently executing macros

   {return} - stop executing the current macro and return control to
              the macro which called the current macro.  If the
              current macro was not called by another macro then
              the macro will stop just as if it had terminated
              normally.

The {cancel} and {return} functions have been added to make working
with the {ifescr} and {ifnescr} functions easier.  The if functions
can be used to test the currently status of the program and delay
macro execution until the program is ready to accept further
keystrokes.  This is more convenient then trying to time how long it
takes and then using the {wait} function (as long as the program
displays some sort of indicator on the screen when it is done).  For
working examples see the macros beginning with "if" in EXAMPLE.KEY.

HINT:  To help determine what row and column a piece of text starts
on, the "cUt" screen has been changed to display the row and column of
the current cursor position.  Just pop up the Newkey menu (alt/),
select "U", move the cursor to the start of the text you want
to check for, note the row & column, and press ESC to cancel the cut.
Then use the macro editor to insert the if function.

See EXAMPLE.KEY for sample macros illustrating the new functions.

Version 5.3

- This version more fully uses EMS memory to save you an additional
15K of memory below the 640K line.

- Menu macros have been changed so that they restart themselves after
the menu option has been selected unless the menu option selected was
defined with a 'y' in the 'exit' column or the menu's exit key was
selected.  Previously the menu macro would always end after a menu
option was selected.

Version 5.2

This version sports an updated user interface.  The new interface
functionally is very similar to earlier versions of 5.0, but with a
more attractive face.  The menu and display macro edit screens have
been slightly rearranged.

Version 5.1

Newkey will now use EMS memory to store its macro and screen
buffer.  EMS memory will be automatically used.  To prevent EMS
usage use the "/noems" parameter when loading Newkey.  For example:

  newkey /3000 /noems

will load Newkey with a 3000 character macro buffer and prevent
usage of EMS memory.

We have been receiving many requests for a very small version.  We
have started development of NEWKEYVS for Newkey Very Small.  This
version does not have the pop-up features and lacks many other
macro functions.  Currently it requires only about 22k, 38k less
than the largest version.  Newkeysm is still available, lacks the
pop-up features, and weighs in at about 35k, 25k less than the
largest version.

                        HINTS

HINTS ON EXECUTING MACROS FROM BATCH FILES

Macros may be executed from batch files using the "newkeysp /ek="
function as described in the Users Guide.  The way this operates can be
confusing.  Assume that you have a macro defined for <alta>.  To execute
this macro in a batch file you would place the following statement:

      "newkeysp /ek=[alta]"

in the batch file.  This will cause the key code associated with the
alta key to be inserted in the keyboard buffer.  Now, the next time the
keyboard buffer is read, alta will be found and the macro associated
with it executed, just as if you had pressed the alta key yourself.

The confusing part of this is that the macro will only execute when the
keyboard is read, but the keyboard is not read while DOS is processing a
batch file.  What this means is that the macro will not execute until
either:

     A. control is returned to the DOS command line or
     B. a program is run in the batch file and the program reads the
        keyboard.

If you wish to execute a macro to drive a program during a batch file
then you should insert the macro into the buffer and then start the
program.  For example, to start WordPerfect and execute a macro when
Wordperfect starts up that will format your letter heading, record a
macro (lets call it WPSTART) within WordPerfect to create the letter
heading and place the following two statements in your batch file:

        newkeysp /ek=[wpstart]
        wp

Now when the batch file is run, the <wpstart> macro will be inserted
into the keyboard buffer and when WordPerfect starts it will read the
keyboard and the <wpstart> macro will execute.

HINTS ON USING MENU MACROS

If you wish to do more in a menu macro than allowed by the menu macro
editor, then define another macro to contain the menu macro and put
the extra macro functions before and after the invocation of the menu
macro as desired.  For example:

{begdef alta}Extra stuff before<menumac>extra stuff after{enddef}

This will allow you to edit the menu macro, <menumac>, without losing
any of the extra stuff.

HINTS ON SENDING CONTROL CHARACTERS TO A PRINTER

To send control codes (x'01'-x'26') use <ctrla> - <ctrlz> in the
<begprint><endprint> function.

IMPORTANT CONVERSION INFORMATION

All users will have to convert their macro files.  Users of
versions earlier than 4.0 will have to convert them more than once.
Pick the appropriate version you are at and follow all of the
instructions that follow:

Version 3.0 or earlier:

Users with version 3.0 or earlier will have to send us a disk and
self-addressed stamped disk mailer and we will put a copy of
conv1to2 conversion progam on.  There was not space on the disk to
accommodate everything we wished to put on it.

Version 4.0:

1.  Run the conv4to5 program and follow instructions.

         COMPATIBILITY WITH OTHER SOFTWARE AND HARDWARE
CRUISE CONTROL

This advice has been passed on by a user of Cruise Control
(you should look at Newkey's own cursor speedup feature, which I
believe works as well as Cruise Control, although a bit
differently of course).

1.  Redefine Cruise Control's hot key by running "CRUISE/R" first.

2.  Turn off Newkey's extended buffer.

3. Turn off either Newkey's or Cruise control's screen saver
feature.

DELL 310 COMPUTER

The 101/102 key keyboard and Phoenix 1.10 09 BIOS do not generate
the correct code for <ctrl\>.  You will have to redefine the "edit
macro being defined" key to something else using the "control
<K>eys" selection from the Newkey pop-up or Newkeysp main menus.

The Phoenix 1.10 09 BIOS will hangup if Newkey is installed and the
extended ascii character generated by pressing alt+2+4+0 on the
numeric keypad is entered.

DESKMATE 3.0 (Tandy)

Deskmate will hang up on non-enhanced keyboards whenever Newkey
tries to create a key and insert it in the buffer.  To solve this
do the following:

1.  Use the "control Keys" option on the Newkeysp menu or Newkey
pop-up menu to change the following control keys:

        dynamic display request <alt/>
        playback multi character <alt,>
        cancel macro <ctrldel>
        cut & paste playback <ctrlins>

to other values.  Make sure that the new values are not also keys
created by Newkey by checking to see if they have an "@" or "*"
next to them in "Appendix C - Extended Codes" in the Newkey users
manual.

2.  Use the "ignore keys" option on the Newkeysp menu to ignore all
keys.  Make these changes permanent when prompted.


DESKMATE/DESKTEAM 1.04 (Alternative Decision Systems)

There are several problems using Newkey together with Deskmate.
Some of these problems can be resolved by changing some of Newkey's
parameters.  Some of them are inherent to the way Deskmate works
and will require changes in the Deskmate program in order to work.

To use with Deskmate do the following:

1.  Turn off the extended keyboard buffer.
2.  Load Newkey after loading Deskmate.

You may notice that Newkey's pop-ups will not work immediately
after using the Deskmate pop-ups.  This happens because Deskmate
apparently does not wait until a completely appropriate time to
pop-up.  If this happens, just do a "DIR" or some other command
first.  This will cause DOS to re-stabilize itself.

The following problems would require Deskmate changes.  If you
encounter these problems we suggest you contact Alternative
Decision Systems.  We have written them a letter trying to resolve
these problems but have received no response.

1. Deskteam will not pop-up if using an enhanced keyboard.

Deskteam apparently waits until an interrupt 16h, ah=0, before
checking to see if its hot key has been struck.  The BIOS on PCs
with the enhanced keyboard, however, supports a new set of calls,
where ah=10h and ah=11h which correspond to the old ah=0 and and
ah=1 calls with the exception that they expose the scan codes on
the separate keypads so that the duplicate keys can be
distinquished from their counterparts on the home keypad.  If an
program only uses these new calls, Deskteam never recognizes its
hot key.  Newkey, as part of its processing always uses the new
calls and as a result Deskteam will not pop up when Newkey is
installed.  Even if Newkey was not installed, Deskteam would not
pop up the program currently running used the new calls.

FOXPRO

Foxpro uses the CTRL-2 keycode for special purposes.  Redefine the
"skip translating next key" hot key to something else (use the
control Keys menu.)

HOMEBASE

This advice has been passed on by a user of Homebase.

1.  Turn off Newkey's extended buffer or instruct Homebase to not
use its own buffer (set option k0 0).

2.  Turn off Homebase's Clock Display (set option -c0 0) or
Newkey's CAP/NUM display.


MS-WORD

1.  Turn on the "shift status reset" option.  For a further
explanation consult the Newkey manual.

2.  It may be necessary to turn off the extended buffer, depending
on which version of MS-WORD is being used.

3.  Use the "ignore keys" option on the Newkeysp menu to ignore
keys which MS-Word tries to create it self.

See section on PC-Write for related information.

PC-WRITE

1.  Turn on the "shift status reset" option.  For a further
explanation consult the Newkey manual.

2.  You may want to use the "ignore keys" option on the Newkeysp
menu to ignore keys which MS-Word tries to create it self.

See PC-Write in the index of the User's guide for related
information.

TANDY 1000SX

There are minor incompatibilities with interpretation of the
numeric and separated keypads.  Evidently these keys do not all
produce the same key codes as the IBM PC.  The net effect is that
many of these keys will be mistaken by Newkey for other keys.  An
example might be that if had a macro assigned to <alt]>, it would
be played back if you pressed <altnum.>.


WORDSTAR 4.0

Wordstar 4.0 works a little differently than Wordstar 3.3.
If you feed keystrokes back too quickly to Wordstar 4.0 it will
discard them, Wordstar 3.3 did not.  To get around this just make
sure that slow typing mode is on when Newkey macros execute.
Wordstar 4.0 also require the alternate fast key mode described
earlier in this readme.

XYWRITE 3.53

This latest version of Xywrite works with Newkey without any
apparent problems.

                FILES SUPPLIED WITH NEWKEY 5.4

Sample Macro Files

Several sample macro files are supplied with Newkey to illustrate
its use and provide you with a starting point.  These files are
described below.

DEMO.KEY

This macro file is used to take you on a guided tour designed to
illustrate Newkey's major features and requires 192k of memory.  To
take the tour, issue the command "demo".  This macro file is an
example of display macros.

DVORAK.KEY - Dvorak keyboard customization

This file contains the macros necessary to redefine your keyboard
to the Dvorak layout.  There is one minor problem in using the
Dvorak layout with the Caps Lock feature.  Caps Lock will only lock
the standard alphabet into shift mode.  Since the Dvorak layout
uses some non-alphabetic keys, the Caps Lock feature will not
automatically capitalize these keys, although normal shifting will.

EXAMPLE.KEY - Example macros

MENU.KEY - Example menu macros

This macro file illustrates many Newkey functions.

Other files on the Newkey Disk

CONV4TO5.EXE - Program to convert version 4.0 files to version 5.0
internal format files.

DEMO.BAT - This batch file will give you a demonstration of Newkey.
It requires 192k of memory.

EXAMPLE.BAT - examples of how to use Newkeysp in batch mode.

LOADNEW.BAT - illustrates how to load Newkey and a macro file from
a batch file.

NEWKEY.EXE - This program actually replaces the keyboard
interrupts (x'9' and x'16').  It is always present while other
programs execute and unless called upon to translate, will be
transparent.

NEWKEYSM.EXE - This is the small version of Newkey.exe.  It lacks
the pop-up features and is about 25k smaller.

NEWKEYSP.EXE - This program provides several functions necessary to
effectively use Newkey and is described further in the users manual.

NEWKEYVS.EXE - This is the very small version of Newkey.exe.  It
lacks the pop-up features plus several other features and is about
38k smaller.

ORDER.FRM - Current Newkey prices and order form.

README - This file will contain any Newkey updates that may have
come up since this manual was printed and information on using
Newkey with other software.